"""
本模块提供各种操纵时间值的函数。

时间有两种标准表示法。一是时间戳表示，可能是一个整数或浮点数（表示秒的分数）。
“纪元”由系统定义；在 Unix 中，它一般指 1970 年 1 月 1 日。
实际开始时间可以通过调用 <世界时元组(0)> 来获得。
另一种方法是用包含 9 个整数的元组来表示当地时间。元组各项如下：
  年 (例如 1998)
  月 (1-12)
  日 (1-31)
  时 (0-23)
  分 (0-59)
  秒 (0-59)
  周i（一周中的第 i 天，i 为 0-6，星期一为 0，以此类推）
  年i（一年中的第几天，i 为 1-366）
  是夏令时（-1、0 或 -1）
如果夏令时标志为 0，表示时间是在正常时区给出的；
如果夏令时标志为 1，表示时间是在夏令时时区给出的；
如果夏令时标志为-1，<元组转秒()>应该根据时间与日期来猜测。
"""

从 time 导入 *
从 collections 导入 namedtuple

时间元组 = namedtuple('时间元组', '年 月 日 时 分 秒 周i 年i 是夏令时')
# 时间元组.__new__.__defaults__ = (False, False, False, False, False, False, False, False, False, 0, 0)
函 时间元组汉化(st) -> 时间元组:
    '''汉化命名元组 struct_time'''
    年 = st.tm_year
    月 = st.tm_mon
    日 = st.tm_mday
    时 = st.tm_hour
    分 = st.tm_min
    秒 = st.tm_sec
    周i = st.tm_wday
    年i = st.tm_yday
    是夏令时 = st.tm_isdst
    返回 时间元组(年, 月, 日, 时, 分, 秒, 周i, 年i, 是夏令时)

